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BETA DISK USERS CLUB 


BETA DISK NEWS WETTER NO. 5 


Hello again. First, some news about a new product for the 
Beta. It's a little bit different than anything previously 
available. A German software house called Individual Software 
has produced a replacement EPROM for the Beta, it's called 
VISION and it can be used with 3.xx and 4.xx Beta interfaces. 


The EPROM contains the Beta [OS software as normal but 
additional code has been implemented to produce a program that 
provides a new operating envirenment for Beta DOS, it’s 
basically a desktop package and prcevides a means of driving Beta 
DOS from pull down menus and pointers. The pointer may be 
controlled via the keyboard, Kempston mouse or keyboard mouse 
( a device produced by Individual, which simulates a joystick 
and is plugged-in a joystick interface ). ae 

Most functions can be carried ovt with single keypresses from 
menus. The technical information states the package is capable 
of supporting upto four drives and is able to drive printers. 
The price of the package as a 16K replacement EPROM is £15 
plus £2 P&P. Individual also preduce a range of other Beta 
related software packages. The newsletter will hopefully have’ a 
review in the next issue. : 

More information can be obtained direct from Individual 
Software, Volker Marohn, Am Beilstieck 30, 4600 Dortmund 50, West 
German:’ or see the enclosed information sheet. “ 


More about new products. Myrmidon Software has Just released 
an updated version of ‘The Last Word’ word processor package, 
to be saiarketed by Trojan Products. Nick Buckingham -who) runs 
Myrmidon tells me it’s a much imprcved version with many new and 
revamped features including a re-written Beta DOS handling 
routine. Also, the previously separate extension software has 
been integrated into the maifn package. The specification 
certainly looks impressive. Myrmidon originally wrote TLW for 
the now defunkt Saga Systems who ccllapsed several months ago. 
Myrmidon is providing support for TLW users. : 


Another Liquidation was announced recently that of Kempston 
( of joystick interface fame ). Kempston also produced a disk 
interface known as the KDOS but surport for this interface was 
never strong, fewer software houses supported the KDOS than Beta 
DOS, although versions of Art Studio using KDOS were produced. 


ea 


SPLITTER PROGRAM MODIFICATION FOR 5.XX TRDOS. BY M.J.SMITH BDUC. 


Here are the modifications for using Bernhard Lutz’ splitter 
program as featured in the last issue. The instructions for 
creating the main program should be followed but before the 
program is saved the following: modifications to the listing 
should be included. ; 

1.Load your splitter basic from the last issue add/edit lines 
as follows. ‘ 

1@ LET DOS = VAL “15619" 
300 RANDOMIZE USR VAL "15616" _ 
B999 STOP: REM LOADER 27080,20 ; . 
9000 DATA @,0,0,33,0,0,22,6,30,0,6,1,8,0,0,14,5, 205,19, 61, 201 
{ 
2.Delete lines 9010-9036, these are no longer requiredr 


3.Save as described. 


VERSION 4.XX DISASSEMBLY. ( 27(}@@=6978H ) 


6978 CDEB3C CALL 3C6B |. ;switch DOS on (15467) 
697B 210000 LD HL,@900 ;buffer address 
697E 1608 LD D,@o | ; track 
6980 1EQO LD E,@o . ;sector number 
6982 3EOL LD A,@1 - j;length 
6984 @6G1 LD B,@1 ;number of sectors 
6986 GEGO LD c,2o | H 
6988 F5 PUSH AF \ ;save value 
6989 C5 PUSH BC ; ;save value 
686A DS PUSH DE | ssave value 
-698B CDD62E CALL 2ED6 j ;read disk (11980) 
698E D1 POP DE { ;return value 
698F Ci POP BC ; j;return value 
6990 ic ; INC E | ;sector counter+1 
“6991 3E1@ LD A,10 | ;load A reg,sectors/track. 
6993 BB CP E H ;if sector=16 
6994 CCA169 CALL 2,69A}, ; jump to track counter 
6997 Fl POP AF ‘ ‘return value 
6998 3D DEC A | 3 
6999 2862 JR Zz, 699D ;all done switch DOS off 
699B 18E7 JR 6984 ° ;do another sector 
699D CD7C3C CALL 3C7C | ;switch DOS off (15484) 
69AD cg RETURN ‘ ;end 
69A1 1EOO LD E,22 | ;zero sector counter 
69A3 14 INC D j;track+l 
69A4 cg RET | ;return 
i 
t 





” 


The modification for 5.XX DOS is quite simple. In the version 
4.XX disassembly above the program counts the tracks read = and 
increments the sector counter when 16 tracks have been 
processed. For version 5.XX the DOS takes care of this process 
and the coding is now simplfied. The DOS routine is called with 
the total number os sectors to read in the B register. 


VERSION 5.XX DISASSEMBLY. ( 270@@=6978H ) 


6978 @O NOP ;make space 

6979 4) NOP 

6980 OG NOP 4 

69861 218000 LD HL,0000 ;,buffer address 

6984 1680 LD D, &@ ;load D reg track number 
6986 1EQO LD E, @@ ;load E reg sector number 
6988 260100 LD B, 22 ;number of sectors 

698B OO NOP ;make space 

698C (2f4) NOP » 

698D EOS LD C,@5 ;routine 5,read data 
698F  CD133D CALL 3D13 -ido it 2 
6992 cg RET ;finish 


Remember the magic file must be located on track 1 sector @ for 
this program to operate correctly this is achieved by saving the 
snapshot on a Clean disk. 


Another enhancement would be to have the program automatically — 


save all four combinations of interrupt mode and interrupts 
enabled or disabled, It would then be much simpler to find the 


split version that works. The program could use suffix A to D,° 


thus. j 
File A IMi, interrupts enabled. 

File B IM1, interrupts disabled. 
File C IM2, interrupts enabled. 

File D IM2, interrupts disabled. 
This feature could be added as another subroutine, but memory 
space for the basic part is limited ‘so other features like the 
menu section could be overwritten. Ih this version there would 
not be any requirement to select options from a menu since the 
program would be automatic. Anybody willing to do the mods? 


FILE UNDELETE. TRDOS 5.XX. BY M. J. SMITH. BDUC. 


é 
' 


This short program enables files to be recovered from a disk 
if they have been previously ERASED' from the disk catalogue, 
however files cannot be recovered if a MOVE has be executed 
since this operation repacks and tetally deletes the program 
from the disk. 


1 TRON SE Coen ER ee 


The code to call routine numter 5, read data ( see last 
issue ) is loaded by line 3@ from the data in line 49. 

The data for the files is contained on track @ sector @ and 
the catalogue is 16 sectors long ( 4096 bytes ). This is read by 
the code and the data is stored.in buffer address 32000. The 
loop in lines 120 to 16@ searches for the deleted file marker in 
this case 1 and replaces it with another marker that the DOS 
recognises as a legal name for display. The whole buffer is now 
written back to track @ sector @ using routine number 6. 

The recovered file will now begin with the character ! and 
may be loaded normally. The program checks the disk catalogue 
for the erased file marker and returns with the message “No 
Files” if an attempt is made to undelete files from a disk with 
no files tagged with the erased tmarker 1. 

The recovered file may be rendmed and the MOVE function may 
be used as normal. The code is similar to that for the splitter 
program above. The information for the routine is POKED from 
within the program. 

There may be a problem with undeleting files if the same 
characters appear in a filename :after character 2. Also the 
program will not undelete the last deleted file in the 
directory, since TRDOS does not rewrite track zero, it just 
forgets that the last file was ever created and uses the file 
space when accessing the disk for saving. 


Listing 1. E 
10 CLEAR 29999 A 
20 LET F=0: LET P=0: LET N$="*. 
30 CLS _: PRINT AT 10,0; “FILE UNDELETE” 1+ “READING CATALOGUE. .. P 
LEASE WAIT" 
4@ RESTORE : FOR A=3@000 TO sone: READ D: POKE A,D: NEXT A 
58 DATA 8,8,9,33,0,0, 22,9, 30,0'6,1,8,8,@, 14,5, 205, 19,61, 201 
68 LET B2=32000: LET T=0: LET $=@: LET L=16 
7G LET HI=INT (B2/256): LET LO=B2-HI¥*256 
82 POKE 30004,LO: POKE 30005,Ht 
90 POKE 30007,T j 
182 POKE 30009,S 
110 POKE 30011,L 
120 RANDOMIZE USR 30000 
130 IF P=1 THEN POKE (B2+244),@: LET P= 2: GO TO 219 
140 FOR X=B2 TO B2+(L*256) sal 16 
15@ FOR I=@ TO 7 
160 LET N$=N$+CHR$ (PEEK (X+I)) 
170 IF (PEEK (X))=1 THEN POKE (X),33: LET F=1 
180 NEXT X 
190 IF F=@ THEN GO TO 260 
200 PRINT ’"FILES UNDELETED"'' “WRITING CATALOGUE. ..PLEASE WAIT" 


200 PRINT ’“FILES UNDELETED”'’ “WRITING CATALOGUE. ..PLEASE WAIT” 

218 POKE 30016,6 ‘ 3 

228 RANDOMIZE USR 38000 

230 IF P=1 OR P=2 THEN GO TO 270 

240 LET B2=32000: LET T-@: LET S= 8: LET L=1: POKE 30016,5: LET 
P=1 

25@ GO TO 70 

260 PRINT ’"NO FILES” 


DOS ROUTINES - PART 2 EXAMPLES. BY HENDRICK BROOTHAERS. 


This is part two of this article, it contains three examples 
of how to use the DOS routines from machine code for 4.XX DOS. 


1. The following example send a catalogue to the screen. 


EXAMPLE ONE 


CALL 3C@6 iswitch DOS on 

PUSH HL ;put the DOS off return address on the cba 
LD A, @2 ;select stream 2 (screen) 

LD C,@7 sset for DOS routine 7 (catalogue) 

CALL 3BFD ;call DOS to execute routine 7 

RET jreturn via DOS off address 


2. The next examples is a combination of three things. 


This code must be entered with tne DE register pair pointing to 
a memory area that holds a file name and type. 

First the filename is moved to the DOS variables using routine 
19, now the disk catalogue is searched to see if the file 
exists on the diskette using routine 10, if the file is not in 
the catalogue then address S5D@F.contains FF,if the file exists, 
address 5DOF contains the number of the file in the catalogue. 


Finally the information for the file is moved from track zero to 
the DOS variables. The data moved has the file length, sector, 
track and is moved by routine 8 © 


EXAMPLE TWO 


CALL 3C@6 ;switch DOS on . ; 

PUSH HL ;push return address . 

EX DE, HL ;make HL point to the file name 

LD C,13 ;set for DOS routine 19 (13H) 

CALL 3BFD ;CALL routine 19, move filename to DOS vars 
LD A, 43 ;character "C” code 67 (43H) 


LD (5CE5),A ;set file type in DOS variable for file type 

LD C,@A ;set for DOS routine 18 (@AH) 

CALL 3BFD ;CALL routine 10, search file in disk catalogue 
LD A, (5DOF) get result in A register 

CP FF ;check if file exists 

RET Z ;return if file does not exist 

LD C, @8 ;set for DOS routine 8 

CALL 3BFD ;CALL routine 8,move file info to DOS vars 

RET ;return via DOS off address 


3. This example shows how routines may be called from within 
other routines. : 
Lines 1 to 1@ are a routine to LOAD a file from disk,when the 
routine is entered at line 1, the- file is loaded to memory 
starting at A@@@. When the routine is entered at line 2, the 
file is loaded in memory starting at the address held in the DE 
register on entry. 


EXAMPLE THREE - 


1 LD DE,A@@Q@ ;set DE to buffer address 40960 (A@QO) 

2 CALL 3C@6 ;switch DOS on 

3 PUSH HL ;save return address 

4 CALL 32 ;CALL routine to select drive 

5 EX DE, HL j;@et buffer address in HL register pair 

6 XOR A ;clear the A register 

7 LD (5D10),A ;set 5D1@ to @ (see routine 14 information) 
8 LD A,1i ;A redister=1 (load to address in HL) 

9 LD C,14 ;set for DOS routine 14.to load the file 

10 


JR: 24 ;gO execute routine 14 and return via DOS off. 


Lines 20 to 25 catalogue the disk to the screen. 


20 CALL 3C@6 ;switch DOS on “4 


21 PUSH HL ;save return 

22 LD A, @2 ;select stream 2=screen 

23 LD C,@7 sset for DOS routine 7=catalogue 
24 CALL 3BFD ;execute routine in C register 
25 RET ;return 


Lines 30 to 42 selects the drive from the number in the memory 
location Al23 number is in memory location A123, then calls 
the catalogue routine. 


30 CALL 3C@6 ;switch DOS on | 
31 PUSH HL ;save return ad dress 
32 PUSH DE ;save value 


33 PUSH BC ;save value 





' 33 PUSH BC jsave value 

do 34 PUSH AF ;save value 

: 7 35 LD 4,(A123) ;load A register with drive number 

‘ . 36 LD C,@1 ;set for DOS routine l=select drive 

. 37 CALL 24 ;go0 select drive (via the call in line 24) 
38 CALL 22 ;do a CAT 

ii 39 POP AF ;@et value back 

; 4@ POP BC ;@et value back 

i 41 POP DE :get value back 
42 RET ;return 


This is the last part of the Machine code and Beta DOS article. 
Thanks again to Hendrick Broothaers in Belgium. 


FLOPPY DISK DRIVE- USER LINKS. BY M.J.SMITH. BDUC. 


The Beta interface is capable of supporting multiple drives 

yo which are handled automatically by the interface firmware and 

_ floppy disk control chip. If multiple drives are used some 

%: knowledge of floppy drive link options is required, especially 
if the user wishes to upgrade from a single drive. » 


these are based around the Mitsubishi MF503A, 5.25" double 
sided drive, ( similar to the drives supplied by TR ), but are 


| 
| , Here is an explanation of the links for most types of drive, 
! also applicable to most drives of Japanese origin. 


These links determine the physical identity of the drive, for 
the first drive, logical unit @ or drive A link DSO is made. 
[ For the second drive logical unit 1 or drive B, DS1 is made. 
1 


| F 1:Drive Select. 
| 


' Drive 1 DS® - IN Drive 2 DS@ - OUT 
i : DS1 - OUT ; DS1 - IN Z 


BETA CONFIG:Drive A - DS@ IN Drive B - DSi IN 


; If MX is in place the drive will react to any drive select 
—_ command. Hence would normally be out in most applications. 
I BETA CONFIG: MX - OUT 


‘ 2:Motor Commands. 
! These links determine various functions for the drive as 
; follows: ioe 


OUT 
OUT 
OUT 


IN 


OUT 
OUT 
IN , 


IN 
ouT 
OUT 


OUT 


you 


Motor starts by motor on command. MM - IN MS 

Motor starts by drive select. MM - OUT MS 

Motor starts by motor on or drive.select. - MM - OUT MS 

Motor starts by IN USE latched by 

drive select. pin 4. : MM - IN MS 
é IU - IN 

BETA CONFIG: MM - IN MS - OUT 

3:Status Commands. 

Standard Ready. ; 2S ~ OUT DC 

Hold Ready. : ‘4 eg 2S - IN DC 

Disk Change. ( Reset by drive select ) . | 28 - IN DC 

Termination resistor. Used in last physical 

drive. TD - last drive. 

BETA CONFIG: 2S - OUT DC - OUT TD - IN ( last drive ) 

4: Indicator. . 

LED will not light. : B Iu - OUT IS 

LED will light with drive select. 4 “- Ty - OUT IS 

LED will light with IN USE signal. IU - IN Is 

LED will light with the logical sum 

of the drive select and IN USE sigtals. F IU - IN Is 

IL - OUT 

BETA CONFIG: IU -_0UT IS ~ OUT IL - OUT 

Please note this information is intended as a guide only, 

should consult the manufacturer's specification sheets 


verify correct link settings. 
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